home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-1.iso / Files / Unstuff / Other Compression / UnzipMAc5.0.sit / Unzip 5.0p1 f / Source / unzip.1 < prev    next >
Encoding:
Text File  |  1993-01-23  |  8.3 KB  |  245 lines  |  [TEXT/MPS ]
  1. .TH UNZIP 1 "22 Aug 92 (v5.0)"
  2. .SH NAME
  3. unzip \- list/test/extract from a ZIP archive file
  4. .SH SYNOPSIS
  5. \fBunzip\fP [ \-\fBcflptuvxz\fP[\fBajnoqUV\fP] ] \fIfile\fP[\fI.zip\fP] [\fIfilespec\fP\ ...]
  6. .SH ARGUMENTS
  7. .IP \fIfile\fP[\fI.zip\fP] \w'[\fIfilespec\fP]'u+2m
  8. Path of the ZIP archive.  The suffix
  9. ``\fI.zip\fP'' is applied if the \fIfile\fP specified does not exist.
  10. Note that self-extracting ZIP files are supported; just specify the
  11. ``\fI.exe\fP'' suffix yourself.
  12. .IP [\fIfilespec\fP]
  13. An optional list of archive members to be processed.
  14. Expressions may be used to match multiple members; be sure to quote
  15. expressions that contain characters interpreted by the operating
  16. system. See DESCRIPTION (below) for more details.
  17. .SH OPTIONS
  18. .PD 0
  19. .IP \-c \w'\-c'u+2m
  20. extract files to stdout/screen (``CRT'')
  21. .IP \-f
  22. freshen existing files (replace if newer); create none
  23. .IP \-l
  24. list archive files (short format)
  25. .IP \-p
  26. extract files to pipe; no informational messages
  27. .IP \-t
  28. test archive files
  29. .IP \-u
  30. update existing files; create new ones if needed
  31. .IP \-v
  32. list archive files (verbose format)
  33. .IP \-x
  34. extract files in archive (default)
  35. .IP \-z
  36. display only the archive comment
  37. .PD
  38. .SH MODIFIERS
  39. .PD 0
  40. .IP \-a \w'\-a'u+2m
  41. convert to MS-DOS textfile format (CR LF), Mac format (CR), Unix/VMS
  42. format (LF), OR from ASCII to EBCDIC, depending on your system (only
  43. use for TEXT files!)
  44. .IP \-j
  45. junk paths (don't recreate archive's directory structure)
  46. .IP \-n
  47. never overwrite existing files; don't prompt
  48. .IP \-o
  49. OK to overwrite files without prompting
  50. .IP \-q
  51. perform operations quietly (\-qq \(rh even quieter)
  52. .IP \-s
  53. [OS/2, MS-DOS] allow spaces in filenames (e.g., ``EA\ DATA.\ SF'')
  54. .IP \-U
  55. leave filenames uppercase if created under MS-DOS, VMS, etc.
  56. .IP \-V
  57. retain (VMS) file version numbers
  58. .IP \-X
  59. [VMS] restore owner/protection info (may require privileges)
  60. .PD
  61. .SH DESCRIPTION
  62. .I UnZip
  63. will list, test, or extract from a ZIP archive, commonly found on MSDOS
  64. systems.
  65. Archive member extraction is implied by the absence of the \-c, \-p,
  66. \-t, \-l, \-v or \-z options.  All archive members are processed unless a
  67. .I filespec
  68. is provided to specify a subset of the archive members.  The
  69. .I filespec
  70. is similar to an egrep expression, and may contain:
  71. .sp 1
  72. .ta \w'[...]'u+2m
  73. *    matches a sequence of 0 or more characters
  74. .br
  75. ?    matches exactly 1 character
  76. .br
  77. \\nnn    matches the character having octal code nnn
  78. .PD 0
  79. .IP [...] \w'[...]'u+2m
  80. matches any single character found inside the brackets; ranges
  81. are specified by a beginning character, a hyphen, and an ending
  82. character.  If an exclamation point or a carat (`!' or `^') follows
  83. the left bracket, then the range of characters matched is complemented
  84. with respect to the ASCII character set (that is, anything except the
  85. characters inside the brackets is considered a match).
  86. .PD
  87. .SH ENVIRONMENT OPTIONS
  88. \fIUnZip\fP's default behavior may be modified via options placed in
  89. an environment variable.  This can be done with any option, but it
  90. is probably most useful with the
  91. \-q, \-o, or \-n modifiers:  in order to make \fIUnZip\fP quieter by 
  92. default, or to make it always overwrite or never overwrite files as it
  93. extracts them.  For example, to
  94. make \fIUnZip\fP act as quietly as possible, only reporting errors, one would
  95. use one of the following commands:
  96. .ta \w'tabset'u +\w'UNZIP=-qq; export UNZIP'u+4m
  97. .PP
  98. .IP "\tsetenv UNZIP -qq\tUnix C shell"
  99. .br
  100. .IP "\tUNZIP=-qq; export UNZIP\tUnix Bourne shell"
  101. .PP
  102. .IP "\tset UNZIP=-qq\tOS/2 or MS-DOS"
  103. .PP
  104. .IP "\tdefine UNZIP_OPTS ""-qq""\tVMS (quotes for LOWERCASE)"
  105. .PP
  106. Environment options are, in effect, considered to be just like any other
  107. command-line options, except that they are effectively the first options
  108. on the command line.  To override
  109. an environment option, one may use the ``minus operator'' to remove it.  For
  110. instance, to override one of the quiet-flags in the example above, use the
  111. command
  112. .PP
  113. .IP "\t\fIunzip\fP \-\-q[other options] zipfile"
  114. .PP
  115. The first hyphen is the normal
  116. switch character, and the second is a minus sign, acting on the q option.
  117. Thus the effect here is to cancel a single quantum of quietness.  To cancel
  118. both quiet flags, two (or more) minuses may be used:
  119. .PP
  120. .IP "\t\fIunzip\fP \-x\-\-q zipfile"
  121. .PP
  122. or
  123. .PP
  124. .IP "\t\fIunzip\fP \-\-\-qx zipfile"
  125. .PP
  126. (the two are equivalent).  This may seem awkward
  127. or confusing, but it is reasonably intuitive:  just ignore the first
  128. hyphen and go from there.  It is also consistent with the behavior of Unix
  129. nice(1).
  130. .PD
  131. .SH EXAMPLES
  132. To use \fIUnZip\fP to extract all members of the archive letters.zip,
  133. creating any directories as necessary:
  134. .PP
  135. .IP "\t\fIunzip\fP letters"
  136. .PP
  137. To extract all members of letters.zip to the current directory:
  138. .PP
  139. .IP "\t\fIunzip\fP -j letters"
  140. .PP
  141. To test letters.zip, printing only a summary message indicating
  142. whether the archive is OK or not:
  143. .PP
  144. .IP "\t\fIunzip\fP -tq letters"
  145. .PP
  146. To extract to standard output all members of letters.zip whose names end
  147. in ``.tex'', converting to the local end-of-line convention and piping the
  148. output into more(1):
  149. .PP
  150. .IP "\t\fIunzip\fP \-ca letters \e*.tex | more"
  151. .PP
  152. (The backslash before the asterisk is only required if the shell expands
  153. wildcards, as in Unix; double quotes could have been used instead, as in
  154. the source example below.)\ \ To extract the binary file paper1.dvi to 
  155. standard output and pipe it to a printing program:
  156. .PP
  157. .IP "\t\fIunzip\fP \-p articles paper1.dvi | dvips"
  158. .PP
  159. To extract all FORTRAN and C source files--*.f, *.c, *.h, Makefile (the
  160. double quotes are necessary only in Unix and only if globbing is turned on):
  161. .PP
  162. .IP "\t\fIunzip\fP source.zip ""*.[fch]"" Makefile"
  163. .PP
  164. To extract only newer versions of the files already in the current directory,
  165. without querying (NOTE:  be careful of unzipping in one timezone a zipfile 
  166. created in another--ZIP archives contain no timezone information, and a 
  167. ``newer'' file from an eastern timezone may, in fact, be older):
  168. .PP
  169. .IP "\t\fIunzip\fP \-fo sources"
  170. .PP
  171. To extract newer versions of the files already in the current directory and
  172. to create any files not already there (same caveat as previous example):
  173. .PP
  174. .IP "\t\fIunzip\fP \-uo sources"
  175. .PP
  176. .PP
  177. In the last five examples, assume that UNZIP or UNZIP_OPTS is set to -q.
  178. To do a singly quiet listing:
  179. .PP
  180. .IP "\t\fIunzip\fP \-\fIl\fP \fIfile\fP"
  181. .PP
  182. To do a doubly quiet listing:
  183. .PP
  184. .IP "\t\fIunzip\fP \-\fIql\fP \fIfile\fP"
  185. .PP
  186. To do a standard listing:
  187. .PP
  188. .IP "\t\fIunzip\fP \-\-\fIql\fP \fIfile\fP"
  189. .PP
  190. or
  191. .PP
  192. .IP "\t\fIunzip\fP \-\fIl\fP\-\fIq\fP \fIfile\fP"
  193. .PP
  194. or
  195. .PP
  196. .IP "\t\fIunzip\fP \-\fIl\fP\-\-\fIq\fP \fIfile\fP"
  197. .PP
  198. (extra minuses don't hurt).
  199. .PD
  200. .SH TIPS
  201. The current maintainer, being a lazy sort, finds it very useful to define
  202. an alias ``tt'' for ``unzip -tq''.  One may then simply type ``tt zipfile''
  203. to test the archive, something which one ought make a habit of doing.
  204. With luck \fIUnZip\fP will report ``No errors detected in zipfile.zip,''
  205. after which one may breathe a sigh of relief.
  206. .PD
  207. .SH SEE ALSO
  208. funzip(1), zip(1), zipcloak(1), zipinfo(1), zipnote(1), zipsplit(1)
  209. .PD
  210. .SH AUTHORS
  211. Samuel H. Smith, Carl Mascott, David P. Kirschbaum, Greg R. Roelofs, Mark
  212. Adler, Kai Uwe Rommel, Igor Mandrichenko, Johnny Lee, Jean-loup Gailly; Glenn
  213. Andrews, Joel Aycock, Allan Bjorklund, James Birdsall, Wim Bonner, John Cowan,
  214. Frank da Cruz, Bill Davidsen, Arjan de Vet, James Dugal, Jim Dumser, Mark
  215. Edwards, David Feinleib, Mike Freeman, Hunter Goatley, Robert Heath, Dave
  216. Heiland, Larry Jones, Kjetil J(o)rgenson, Bob Kemp, J. Kercheval, Alvin Koh,
  217. Bo Kullmar, Johnny Lee, Warner Losh, Fulvio Marino, Gene McManus, Joe Meadows,
  218. Mike O'Carroll, Humberto Ortiz-Zuazaga, Piet W. Plomp, Antonio Querubin Jr.,
  219. Steve Salisbury, Georg Sassen, Jon Saxton, Hugh Schmidt, Martin Schulz, Charles
  220. Scripter, Chris Seaman, Richard Seay, Alex Sergejew, Cliff Stanford, Onno van
  221. der Linden, Jim Van Zandt, Antoine Verheijen, Paul Wells.
  222. .PD
  223. .SH VERSIONS
  224. .ta \w'vx.x\ \ 'u +\w'fall 1989\ \ 'u
  225. .PD 0
  226. .IP "v1.2\t15 Mar 89" \w'\t\t'u
  227. Samuel H. Smith
  228. .IP "v2.0\t\ 9 Sep 89"
  229. Samuel H. Smith
  230. .IP "v2.x\tfall 1989"
  231. many Usenet contributors
  232. .IP "v3.0\t\ 1 May 90"
  233. Info-ZIP (DPK, consolidator)
  234. .IP "v3.1\t15 Aug 90"
  235. Info-ZIP (DPK, consolidator)
  236. .IP "v4.0\t\ 1 Dec 90"
  237. Info-ZIP (GRR, maintainer)
  238. .IP "v4.1\t12 May 91"
  239. Info-ZIP
  240. .IP "v4.2\t20 Mar 92"
  241. Info-ZIP (zip-bugs subgroup; GRR, maint.)
  242. .IP "v5.0\t21 Aug 92"
  243. Info-ZIP (zip-bugs subgroup; GRR, maint.)
  244. .PD
  245.